home *** CD-ROM | disk | FTP | other *** search
/ Aminet 40 / Aminet 40 (2000)(Schatztruhe)[!][Dec 2000].iso / Aminet / disk / misc / dblocate.readme < prev    next >
Encoding:
Text File  |  2000-11-02  |  3.2 KB  |  76 lines

  1. Short:    A quick find util like locate on Linux
  2. Author:   TimHanson(msinister@connectfree.co.uk)
  3. Uploader: TimHanson(msinister@connectfree.co.uk)
  4. Type:     disk/misc
  5.  
  6. Version 1.1
  7. In this archive are 3 utils: updatedb, locate and locategui. Their purpose 
  8. is to allow quick searches for lost files with pattern matching.
  9.  
  10. To install, copy all the files somewhere like C: or don`t.
  11.  
  12. Usage:
  13.  
  14. updatedb database [quiet]
  15. locate filenamepattern
  16. locategui filenamepattern [viewer]
  17.  
  18. Explaination:
  19.  
  20. To begin with you should run updatedb. This will create a database file. 
  21. This file may be pretty large depending on the size of your harddrive. On
  22. my system it`s about 3Meg and updatedb takes about 10Mins to create it. By 
  23. default the file is stored as s:locatedb. You can name it whatever you want
  24. however with the option on the command line.
  25. eg: updatedb SYS:prefs/sillynameforafile
  26. updatedb creates an env variable called LOCATEDBNAME to point to this file.
  27. The only other option is QUIET which stops output to stdout.
  28.  
  29. Now you can use locate. This takes one argument; an AmigaDos pattern to 
  30. identify the file you are looking for. This should be a simple file name
  31. with no path but may include AmigaDOS wildcards. Locate then scans the 
  32. database pointed to by LOCATEDBNAME for matches and prints the full path of
  33. any matches to stdout. (ie. The shell it was run from or an indirection 
  34. file if one is supplied.) Locate responds to CTRL-C.
  35.  
  36. Locategui functions in exactly the same way as locate but opens a window on
  37. the default public screen with a listview to display the results. Items in
  38. the listview can be clicked to show them with an external viewer. It takes 
  39. an additional cli argument to determine what viewer should be used to show 
  40. the file. The default is multiview. To stop any further searching click the
  41. window`s close icon.
  42.  
  43. This of course is not a new idea and there are several progs available for 
  44. the amiga that do the same thing. The only advantages this one has is that 
  45. it`s easy to install and use it can be run from anywhere and will work 
  46. under fairly low memory.
  47.  
  48. Bug reports to the address above.
  49. This archive is jokeware. If you use the product regularly you are morally 
  50. obliged to send me an email containing at least one joke.
  51. Distribution via CD is ok as long as you send me a copy.
  52.  
  53. History:
  54. 1.0
  55. A bug came to my attention directly after sending the first archive. The
  56. file patterns were case sensitive. Plainly useless on the Amiga. This is 
  57. now fixed.
  58. Added the ability to view files selected in listview.
  59. 1.1
  60. Changed to ExAll() to get file list in updatedb. Should fix the problem with
  61. hard/soft links.
  62. Changed TagItem data to GT_SetGadgetAttrs() from 0L to ~0L. This stops the 
  63. listview from flickering when a new item is added.
  64.  
  65.  
  66. ============================= Archive contents =============================
  67.  
  68. Original  Packed Ratio    Date     Time    Name
  69. -------- ------- ----- --------- --------  -------------
  70.    11596    6326 45.4% 19-Oct-00 23:45:16 +locate
  71.     2756    1411 48.8% 19-Oct-00 23:54:08 +locate.readme
  72.    15320    8052 47.4% 19-Oct-00 23:45:22 +locategui
  73.     8908    5099 42.7% 19-Oct-00 23:45:32 +updatedb
  74. -------- ------- ----- --------- --------
  75.    38580   20888 45.8% 21-Oct-100 20:11:34   4 files
  76.